Embabel Agent Documentation/com.embabel.agent.api.event.observation

Package-level declarations

Types

ActionObservationContext

class ActionObservationContext(val process: AgentProcess, val action: Action)

Thin context for the embabel.action span: wraps the owning AgentProcess and the Action.

AgentInstrumentation

interface AgentInstrumentation

Port for direct instrumentation at the agent work sites (agent turn, action, LLM call, tool loop).

AgentObservationContext

class AgentObservationContext(val process: AgentProcess)

Thin context for the embabel.agent span: wraps the live AgentProcess, from which the registered convention reads all attributes — status at stop, so it reflects the final outcome.

InternalObservabilityApi

@Target(allowedTargets = [AnnotationTarget.CLASS, AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY])

annotation class InternalObservabilityApi

Marks observability instrumentation types (observation contexts, the AgentInstrumentation port and its helpers) as internal SPI: the core uses them to create spans, but they are not part of the public agent API and may change without notice. Kotlin callers must opt in with @OptIn(InternalObservabilityApi::class).

LlmObservationContext

class LlmObservationContext(val requestEvent: LlmRequestEvent<*>)

Thin context for the embabel.llm span: wraps the LlmRequestEvent; the convention extracts attributes.

NoOpAgentInstrumentation

object NoOpAgentInstrumentation : AgentInstrumentation

No-op default: runs work and creates no observation, never even invoking context. Active whenever no observability module contributes an AgentInstrumentation bean.

Observations

object Observations

Direct-instrumentation helpers used at the agent work sites.

ToolCallOutcomes

object ToolCallOutcomes

Java-friendly view of the Kotlin Result carried by ToolCallResponseEvent, for Java consumers (e.g. the observability module) that cannot read a Kotlin inline value class directly. Lives in this Kotlin module so the read stays native — no reflection.

ToolLoopObservationContext

class ToolLoopObservationContext(val startEvent: ToolLoopStartEvent, val inputMessages: List<Message>)

Thin context for the embabel.tool_loop span: wraps the ToolLoopStartEvent and the inputMessages (the prompt, captured at start). output is set after the loop runs and read by the convention at stop — the only mutable field, since the result is not on the start event.